home *** CD-ROM | disk | FTP | other *** search
/ Apple Developer Connectio…eloper Series 2005 March / Dev.CD Mar 05.iso / What's New / Sample Code / HIObjectThreadController / main.c < prev    next >
Encoding:
C/C++ Source or Header  |  2004-06-22  |  15.2 KB  |  397 lines
  1. /*
  2. *    File:        main.c of HIObjectThreadController
  3. * 
  4.     Contains:    Shows how to control thread from UI and how threads can "control" UI.
  5. *
  6. *  Note:        The project is set up so that the DEBUG macro is set to one when the "Development"
  7. *                build style is chosen and not at all when the "Deployment" build style is chosen.
  8. *                Thus, all the require asserts "fire" only in "Development".
  9. *    
  10. *    Version:    1.0
  11. * 
  12. *    Created:    May 13th, 2004
  13. *
  14. *    Disclaimer:    IMPORTANT:  This Apple software is supplied to you by Apple Computer, Inc.
  15. *                ("Apple") in consideration of your agreement to the following terms, and your
  16. *                use, installation, modification or redistribution of this Apple software
  17. *                constitutes acceptance of these terms.  If you do not agree with these terms,
  18. *                please do not use, install, modify or redistribute this Apple software.
  19. *
  20. *                In consideration of your agreement to abide by the following terms, and subject
  21. *                to these terms, Apple grants you a personal, non-exclusive license, under AppleÕs
  22. *                copyrights in this original Apple software (the "Apple Software"), to use,
  23. *                reproduce, modify and redistribute the Apple Software, with or without
  24. *                modifications, in source and/or binary forms; provided that if you redistribute
  25. *                the Apple Software in its entirety and without modifications, you must retain
  26. *                this notice and the following text and disclaimers in all such redistributions of
  27. *                the Apple Software.  Neither the name, trademarks, service marks or logos of
  28. *                Apple Computer, Inc. may be used to endorse or promote products derived from the
  29. *                Apple Software without specific prior written permission from Apple.  Except as
  30. *                expressly stated in this notice, no other rights or licenses, express or implied,
  31. *                are granted by Apple herein, including but not limited to any patent rights that
  32. *                may be infringed by your derivative works or by other works in which the Apple
  33. *                Software may be incorporated.
  34. *
  35. *                The Apple Software is provided by Apple on an "AS IS" basis.  APPLE MAKES NO
  36. *                WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED
  37. *                WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  38. *                PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN
  39. *                COMBINATION WITH YOUR PRODUCTS.
  40. *
  41. *                IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR
  42. *                CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
  43. *                GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  44. *                ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION
  45. *                OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT
  46. *                (INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN
  47. *                ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  48. *
  49. *    Copyright:  Copyright © 2004 Apple Computer, Inc, All Rights Reserved
  50. */
  51. //****************************************************
  52. #pragma mark * compilation directives *
  53.  
  54. //****************************************************
  55. #pragma mark -
  56. #pragma mark * includes & imports *
  57.  
  58. #include <Carbon/Carbon.h>
  59. #include "SomeTasks.h"
  60. #include "HIObjectThreadController.h"
  61.  
  62. //****************************************************
  63. #pragma mark -
  64. #pragma mark * typedef's, struct's, enums, defines, etc. *
  65.  
  66. //****************************************************
  67. #pragma mark -
  68. #pragma mark * local (static) function prototypes *
  69.  
  70. static pascal OSErr Handle_OpenApplication(const AppleEvent *inAppleEvent, AppleEvent *outAppleEvent, long inHandlerRefcon);
  71. static pascal OSErr Handle_ReopenApplication(const AppleEvent *inAppleEvent, AppleEvent *outAppleEvent, long inHandlerRefcon);
  72. static pascal OSErr Handle_OpenDocuments(const AppleEvent *inAppleEvent, AppleEvent *outAppleEvent, long inHandlerRefcon);
  73. static pascal OSErr Handle_PrintDocuments(const AppleEvent *inAppleEvent, AppleEvent *outAppleEvent, long inHandlerRefcon);
  74. static void Install_AppleEventHandlers(void);
  75.  
  76. static pascal OSStatus Handle_CommandUpdateStatus(EventHandlerCallRef inHandlerCallRef, EventRef inEvent, void *inUserData);
  77. static pascal OSStatus Handle_CommandProcess(EventHandlerCallRef inHandlerCallRef, EventRef inEvent, void *inUserData);
  78.  
  79. static void Do_Preferences(void);
  80. static OSStatus Do_CleanUp(void);
  81.  
  82. //****************************************************
  83. #pragma mark -
  84. #pragma mark * exported globals *
  85.  
  86. //****************************************************
  87. #pragma mark -
  88. #pragma mark * local (static) globals *
  89.  
  90. IBNibRef gIBNibRef;
  91.  
  92. //****************************************************
  93. #pragma mark -
  94. #pragma mark * exported function implementations *
  95.  
  96. /*****************************************************
  97. *
  98. * main (argc, argv) 
  99. *
  100. * Purpose:  main program entry point
  101. *
  102. * Notes:       You might want to change this to something more verbose
  103. *
  104. * Inputs:   argc     - the number of elements in the argv array
  105. *            argv     - an array of pointers to the parameters to this application
  106. *
  107. * Returns:  int      - error code (0 == no error) 
  108. */
  109. int main(int argc, char* argv[])
  110.     {
  111.     OSStatus status;
  112.     
  113.     // Can we run this particular demo application?
  114.     long response;
  115.     status = Gestalt(gestaltSystemVersion, &response);
  116.     Boolean ok = ((status == noErr) && (response >= 0x00001030));
  117.     if (!ok)
  118.         {
  119.         DialogRef theAlert;
  120.         CreateStandardAlert(kAlertStopAlert, CFSTR("Mac OS X 10.3 (minimum) is required for this application"), NULL, NULL, &theAlert);
  121.         RunStandardAlert(theAlert, NULL, NULL);
  122.         ExitToShell();
  123.         }
  124.     
  125.     // Create a Nib reference passing the name of the nib file (without the .nib extension)
  126.     // CreateNibReference only searches into the application bundle.
  127.     status = CreateNibReference(CFSTR("main"), &gIBNibRef);
  128.     require_noerr(status, CantGetNibRef);
  129.     
  130.     // Once the nib reference is created, set the menu bar. "MainMenu" is the name of the menu bar
  131.     // object. This name is set in InterfaceBuilder when the nib is created.
  132.     status = SetMenuBarFromNib(gIBNibRef, CFSTR("MenuBar"));
  133.     require_noerr(status, CantSetMenuBar);
  134.     
  135.     // Enabling Preferences menu item
  136.     EnableMenuCommand(NULL, kHICommandPreferences);
  137.     
  138.     // Let's react to User's commands.
  139.     Install_AppleEventHandlers();
  140.     
  141.     EventTypeSpec eventTypeCP = {kEventClassCommand, kEventCommandProcess};
  142.     InstallEventHandler(GetApplicationEventTarget(), Handle_CommandProcess, 1, &eventTypeCP, NULL, NULL);
  143.     
  144.     EventTypeSpec eventTypeCUS = {kEventClassCommand, kEventCommandUpdateStatus};
  145.     InstallEventHandler(GetApplicationEventTarget(), Handle_CommandUpdateStatus, 1, &eventTypeCUS, NULL, NULL);
  146.     
  147.     // Call the event loop
  148.     RunApplicationEventLoop();
  149.     
  150. CantSetMenuBar:
  151. CantGetNibRef:
  152.     return status;
  153.     }   // main
  154.  
  155. /*****************************************************/
  156. #pragma mark -
  157. #pragma mark * local (static) function implementations *
  158. #pragma mark * AppleEvent Handlers *
  159.  
  160. /*****************************************************
  161. *
  162. * Handle_OpenApplication(inAppleEvent, reply, inHandlerRefcon) 
  163. *
  164. * Purpose:  AppleEvent handler for the kAEOpenApplication event
  165. *
  166. * Inputs:   inAppleEvent    - the Apple event
  167. *           reply            - our reply to the Apple event
  168. *           inHandlerRefcon    - refcon passed to AEInstallEventHandler when this hander was installed
  169. *
  170. * Returns:  OSErr            - error code (0 == no error) 
  171. */
  172. static pascal OSErr Handle_OpenApplication(const AppleEvent *inAppleEvent, AppleEvent *outAppleEvent, long inHandlerRefcon)
  173.     {
  174.     // Create the first thread.
  175.     return HIObjectThreadControllerCreate(CFSTR("Leibniz"), SetUpLeibniz, CalculatingPiUsingLeibnizSimpleTask, TermLeibniz, kSTEndIteration / kSTUIIteration, NULL, NULL);
  176.     }   // Handle_OpenApplication
  177.  
  178. /*****************************************************
  179. *
  180. * Handle_ReopenApplication(inAppleEvent, reply, inHandlerRefcon) 
  181. *
  182. * Purpose:  AppleEvent handler for the kAEReopenApplication event
  183. *
  184. * Inputs:   inAppleEvent    - the Apple event
  185. *           reply            - our reply to the Apple event
  186. *           inHandlerRefcon    - refcon passed to AEInstallEventHandler when this hander was installed
  187. *
  188. * Returns:  OSErr            - error code (0 == no error) 
  189. */
  190. static pascal OSErr Handle_ReopenApplication(const AppleEvent *inAppleEvent, AppleEvent *outAppleEvent, long inHandlerRefcon)
  191.     {
  192.     // We were already running but with no windows so we create an empty one.
  193.     WindowRef theWindow = GetFrontWindowOfClass(kDocumentWindowClass, true);
  194.     if (theWindow == NULL)
  195.         return HIObjectThreadControllerCreate(CFSTR("Leibniz"), SetUpLeibniz, CalculatingPiUsingLeibnizSimpleTask, TermLeibniz, kSTEndIteration / kSTUIIteration, NULL, NULL);
  196.     else
  197.         return noErr;
  198.     }   // Handle_ReopenApplication
  199.  
  200. /*****************************************************
  201. *
  202. * Handle_OpenDocuments(inAppleEvent, reply, inHandlerRefcon) 
  203. *
  204. * Purpose:  AppleEvent handler for the kAEOpenDocuments event
  205. *
  206. * Inputs:   inAppleEvent    - the Apple event
  207. *           reply            - our reply to the Apple event
  208. *           inHandlerRefcon    - refcon passed to AEInstallEventHandler when this hander was installed
  209. *
  210. * Returns:  OSErr            - error code (0 == no error) 
  211. */
  212. static pascal OSErr Handle_OpenDocuments(const AppleEvent *inAppleEvent, AppleEvent *outAppleEvent, long inHandlerRefcon)
  213.     {
  214.     return errAEEventNotHandled;
  215.     }   // Handle_OpenDocuments
  216.  
  217. /*****************************************************
  218. *
  219. * Handle_PrintDocuments(inAppleEvent, reply, inHandlerRefcon) 
  220. *
  221. * Purpose:  AppleEvent handler for the kAEPrintDocuments event
  222. *
  223. * Inputs:   inAppleEvent    - the Apple event
  224. *           reply           - our reply to the Apple event
  225. *           inHandlerRefcon - refcon passed to AEInstallEventHandler when this hander was installed
  226. *
  227. * Returns:  OSErr            - error code (0 == no error) 
  228. */
  229. static pascal OSErr Handle_PrintDocuments(const AppleEvent *inAppleEvent, AppleEvent *outAppleEvent, long inHandlerRefcon)
  230.     {
  231.     return errAEEventNotHandled;
  232.     }   // Handle_PrintDocuments
  233.  
  234. /*****************************************************
  235. *
  236. * Install_AppleEventHandlers(void) 
  237. *
  238. * Purpose:  installs the AppleEvent handlers
  239. *
  240. * Inputs:   none
  241. *
  242. * Returns:  none
  243. */
  244. static void Install_AppleEventHandlers(void)
  245.     {
  246.     OSErr    status;
  247.     status = AEInstallEventHandler(kCoreEventClass, kAEOpenApplication, Handle_OpenApplication, 0, false);
  248.     require_noerr(status, CantInstallAppleEventHandlerOpenAppl);
  249.     
  250.     status = AEInstallEventHandler(kCoreEventClass, kAEReopenApplication, Handle_ReopenApplication, 0, false);
  251.     require_noerr(status, CantInstallAppleEventHandlerReOpenAppl);
  252.     
  253.     status = AEInstallEventHandler(kCoreEventClass, kAEOpenDocuments, Handle_OpenDocuments, 0, false);
  254.     require_noerr(status, CantInstallAppleEventHandlerOpenDocs);
  255.     
  256.     status = AEInstallEventHandler(kCoreEventClass, kAEPrintDocuments, Handle_PrintDocuments, 0, false);
  257.     require_noerr(status, CantInstallAppleEventHandlerPrintDocs);
  258.     
  259.     // Note: Since RunApplicationEventLoop installs a Quit AE Handler, there is no need to do it here.
  260.     
  261. CantInstallAppleEventHandlerOpenAppl:
  262. CantInstallAppleEventHandlerReOpenAppl:
  263. CantInstallAppleEventHandlerOpenDocs:
  264. CantInstallAppleEventHandlerPrintDocs:
  265.     return;
  266.     }   // Install_AppleEventHandlers
  267.  
  268. #pragma mark -
  269. #pragma mark * CarbonEvent Handlers *
  270.  
  271. /*****************************************************
  272. *
  273. * Handle_CommandUpdateStatus(inHandlerCallRef, inEvent, inUserData) 
  274. *
  275. * Purpose:  called to update status of the commands, enabling or disabling the menu items
  276. *
  277. * Inputs:   inHandlerCallRef    - reference to the current handler call chain
  278. *                inEvent             - the event
  279. *           inUserData          - app-specified data you passed in the call to InstallEventHandler
  280. *
  281. * Returns:  OSStatus            - noErr indicates the event was handled
  282. *                                 eventNotHandledErr indicates the event was not handled and the Toolbox should take over
  283. */
  284. static pascal OSStatus Handle_CommandUpdateStatus(EventHandlerCallRef inHandlerCallRef, EventRef inEvent, void *inUserData)
  285.     {
  286.     OSStatus status = eventNotHandledErr;
  287.     
  288.     HICommand aCommand;
  289.     GetEventParameter(inEvent, kEventParamDirectObject, typeHICommand, NULL, sizeof(HICommand), NULL, &aCommand);
  290.     
  291.     WindowRef aWindowRef = GetFrontWindowOfClass(kDocumentWindowClass, true);
  292.         
  293.     if (aWindowRef == NULL)
  294.         {
  295.         switch (aCommand.commandID)
  296.             {
  297.             case kHICommandClose:
  298.                 DisableMenuItem(aCommand.menu.menuRef, aCommand.menu.menuItemIndex);
  299.                 break;
  300.             }
  301.         }
  302.     else
  303.         {
  304.         switch (aCommand.commandID)
  305.             {
  306.             case kHICommandClose:
  307.                 EnableMenuItem(aCommand.menu.menuRef, aCommand.menu.menuItemIndex);
  308.                 break;
  309.             }
  310.         }
  311.  
  312.     return status;
  313.     }   // Handle_CommandUpdateStatus
  314.  
  315. /*****************************************************
  316. *
  317. * Handle_CommandProcess(inHandlerCallRef, inEvent, inUserData) 
  318. *
  319. * Purpose:  called to process commands from Carbon events
  320. *
  321. * Inputs:   inHandlerCallRef    - reference to the current handler call chain
  322. *            inEvent             - the event
  323. *           inUserData          - app-specified data you passed in the call to InstallEventHandler
  324. *
  325. * Returns:  OSStatus            - noErr indicates the event was handled
  326. *                                 eventNotHandledErr indicates the event was not handled and the Toolbox should take over
  327. */
  328. static pascal OSStatus Handle_CommandProcess(EventHandlerCallRef inHandlerCallRef, EventRef inEvent, void *inUserData)
  329.     {
  330.     HICommand aCommand;
  331.     OSStatus status = eventNotHandledErr;
  332.     
  333.     GetEventParameter(inEvent, kEventParamDirectObject, typeHICommand, NULL, sizeof(HICommand), NULL, &aCommand);
  334.     
  335.     switch (aCommand.commandID)
  336.         {
  337.         case kHICommandPreferences:
  338.             Do_Preferences();
  339.             break;
  340.         case 'LEIT':
  341.             HIObjectThreadControllerCreate(CFSTR("Leibniz"), SetUpLeibniz, CalculatingPiUsingLeibnizSimpleTask, TermLeibniz, kSTEndIteration / kSTUIIteration, NULL, NULL);
  342.             break;
  343.         case 'WALT':
  344.             HIObjectThreadControllerCreate(CFSTR("Wallis"), SetUpWallis, CalculatingPiUsingWallisSimpleTask, TermWallis, kSTEndIteration / kSTUIIteration, NULL, NULL);
  345.             break;
  346.         case kHICommandQuit:
  347.             status = Do_CleanUp();
  348.             break;
  349.         }
  350.     return status;
  351.     }   // Handle_CommandProcess
  352.  
  353. #pragma mark -
  354. #pragma mark * Windows *
  355.  
  356. /*****************************************************
  357. *
  358. * Do_Preferences(void) 
  359. *
  360. * Purpose:  routine to display dialog to set our applications preferences
  361. *
  362. * Inputs:   none
  363. *
  364. * Returns:  none
  365. */
  366. static void Do_Preferences(void)
  367.     {
  368.     DialogRef theAlert;
  369.     CreateStandardAlert(kAlertStopAlert, CFSTR("No Preferences yet!"), NULL, NULL, &theAlert);
  370.     RunStandardAlert(theAlert, NULL, NULL);
  371.     }   // Do_Preferences
  372.  
  373. /*****************************************************
  374. *
  375. * Do_CleanUp(void) 
  376. *
  377. * Purpose:  called when we get the quit event, closes all the windows.
  378. *
  379. * Inputs:   none
  380. *
  381. * Returns:  OSStatus   - eventNotHandledErr indicates that the quit process can continue
  382. */
  383. static OSStatus Do_CleanUp(void)
  384.     {
  385.     WindowRef windowToDispose, aWindowRef = GetFrontWindowOfClass(kDocumentWindowClass, true);
  386.  
  387.     while (aWindowRef != NULL)
  388.     {
  389.         windowToDispose = aWindowRef;
  390.         aWindowRef = GetNextWindowOfClass(aWindowRef, kDocumentWindowClass, true);
  391.         
  392.         DisposeWindow(windowToDispose);
  393.     }
  394.     
  395.     return eventNotHandledErr;
  396.     }   // Do_CleanUp
  397.